home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / bw5z303s / zipand~1.txt < prev   
Text File  |  1999-02-03  |  34KB  |  780 lines

  1. These are the Zip and Unzip options to be used in the BW Zip Compress OCX
  2.  
  3. The sample application distributed with the OCX already have the most used commands inside it
  4.  
  5. Notice that not all the arguments can be used in the OCX , but you is welcome to test all
  6.  
  7. Zip and Unzip Options
  8.  
  9. These are the options to be passed to the Zip and Unzip functions using the Options argument , these arguments derived from the zip.exe and unzip.exe files by Infozip.
  10.  
  11.  
  12. ZIP OPTIONS
  13.  
  14.        -A     Adjust self-extracting executable archive.  A self-
  15.           extracting   executable    archive      is  created  by
  16.           prepending the SFX stub to an existing archive. The
  17.           -A  option  tells     zip  to adjust the entry offsets
  18.           stored in the archive to    take  into  account  this
  19.           "preamble" data.
  20.  
  21.             -b path
  22.           Use  the    specified  path     for  the  temporary  archive. For example:
  23.  
  24.             -b /tmp stuff *
  25.  
  26.           will put the temporary zip archive in the directory
  27.  
  28.       /tmp,  copying over stuff.zip to the current direc-
  29.           tory when done. This option  is  only  useful  when
  30.           updating    an  existing archive, and the file system
  31.           containing this old archive does    not  have  enough
  32.           space to hold both old and new archives at the same
  33.           time.
  34.  
  35.        -c     Add one-line comments for each file.   File  opera-
  36.           tions  (adding,  updating)  are done first, and the
  37.           user is then prompted for a  one-line  comment  for
  38.  
  39.       each  file.   Enter the comment followed by return,
  40.           or just return for no comment.
  41.  
  42.        -d     Remove (delete) entries from a  zip  archive.   For
  43.  
  44.       example:
  45.  
  46.             -d foo foo/tom/junk foo/harry/\* \*.o
  47.  
  48.           will  remove  the     entry    foo/tom/junk,  all of the
  49.           files that start with foo/harry/, and  all  of  the
  50.           files  that  end    with .o (in any path).    Note that
  51.           shell pathname expansion has  been  inhibited  with
  52.  
  53.       backslashes,  so    that  zip  can see the asterisks,
  54.           enabling zip to match on the contents  of     the  zip
  55.           archive  instead    of  the     contents  of the current
  56.           directory.
  57.  
  58.           Under MSDOS, -d is case sensitive when  it  matches
  59.           names  in the zip archive.  This requires that file
  60.           names be entered in upper case if they were  zipped
  61.           by PKZIP on an MSDOS system.
  62.  
  63.        -D     Do not create entries in the zip archive for direc-
  64.  
  65.       tories.  Directory entries are created  by  default
  66.           so  that    their  attributes can be saved in the zip
  67.           archive.
  68.  
  69.        -e     Encrypt the contents of the  zip archive using    a
  70.           password    which  is  entered  on the  terminal  in
  71.           response to a prompt (this will not be  echoed;  if
  72.           standard    error is not a tty, zip will exit with an
  73.           error).  The password prompt is  repeated     to  save
  74.           the user from typing errors.
  75.  
  76.        -f     Replace  (freshen)  an  existing    entry  in the zip
  77.           archive only if it has been modified more     recently
  78.           than the version already in the zip archive; unlike
  79.           the update option (-u) this will not add files that
  80.           are not already in the zip archive.  For example:
  81.  
  82.              -f foo
  83.  
  84.           This  command should be run from the same directory
  85.           from which the original zip command was run,  since
  86.           paths stored in zip archives are always relative.
  87.  
  88.       Note  that  the  timezone     environment  variable TZ
  89.           order  for  the -f , -u and -o options to work cor-
  90.           rectly.
  91.  
  92.           The reasons behind this  are  somewhat  subtle  but
  93.           have  to    do with the differences between the Unix-
  94.           format file times (always in GMT) and most  of  the
  95.           other operating systems (always local time) and the
  96.           necessity to compare the two.  A typical    TZ  value
  97.           is  ``MET-1MEST''     (Middle European time with auto-
  98.  
  99.       matic adjustment    for  ``summertime''  or     Daylight
  100.           Savings Time).
  101.  
  102.        -F     Fix  the    zip  archive.  This option can be used if
  103.           some portions of the archive are missing. It is not
  104.           guaranteed  to  work,  so you MUST make a backup of
  105.           the original archive first.
  106.  
  107.           When doubled as in -FF the compressed  sizes  given
  108.           inside  the damaged archive are not trusted and zip
  109.           scans for special signatures to identify the limits
  110.  
  111.       between  the archive members. The single -F is more
  112.           reliable if the archive is not  too  much     damaged,
  113.           for  example  if it has only been truncated, so try
  114.           this option first.
  115.  
  116.           Neither option will recover archives that have been
  117.           incorrectly  transferred    in  ascii mode instead of
  118.           binary. After the repair, the -t    option    of  unzip
  119.           may show that some files have a bad CRC. Such files
  120.           cannot be recovered; you can remove them    from  the
  121.  
  122.       archive using the -d option of zip.
  123.  
  124.        -g     Grow (append to) the specified zip archive, instead
  125.           of creating a new one. If this operation fails, zip
  126.           attempts    to  restore  the  archive to its original
  127.           state. If the restoration fails, the archive  might
  128.           become  corrupted.  This    option    is  ignored  when
  129.           there's no existing archive or when  at  least  one
  130.           archive member must be updated or deleted.
  131.  
  132.        -h     Display the zip help information (this also appears
  133.  
  134.       if zip is run with no arguments).
  135.  
  136.        -i files
  137.           Include only the specified files, as in:
  138.  
  139.              -r foo . -i \*.c
  140.  
  141.           which will include only the files that end in .c in
  142.           the current directory and its subdirectories. (Note
  143.           for PKZIP users: the equivalent command is
  144.  
  145.              pkzip -rP foo *.c
  146.  
  147.           PKZIP does not allow recursion in directories other
  148.           than  the     current  one.)     The backslash avoids the
  149.           shell  filename  substitution,  so  that    the  name
  150.  
  151.       matching    is performed by zip at all directory lev-
  152.           els.
  153.  
  154.           Also possible:
  155.  
  156.          -r foo     . -i@include.lst
  157.  
  158.           which will only include the files     in  the  current
  159.           directory     and  its  subdirectories  that match the
  160.           patterns in the file include.lst.
  161.  
  162.        -I     Don't scan through  Image     files.     This  option  is
  163.           available     on  Acorn  RISC  OS only; when used, zip
  164.           will not consider Image files (eg.  DOS  partitions
  165.  
  166.       or Spark archives when SparkFS is loaded) as direc-
  167.           tories but will store them as single files.
  168.  
  169.           For example, if you have SparkFS loaded, zipping    a
  170.           Spark archive will result in a zipfile containing a
  171.           directory (and its content)  while  using     the  'I'
  172.           option  will result in a zipfile containing a Spark
  173.           archive. Obviously this second case  will     also  be
  174.           obtained    (without the 'I' option) if SparkFS isn't
  175.  
  176.       loaded.
  177.  
  178.        -j     Store just the name  of  a  saved file  (junk  the
  179.           path),   and  do    not  store  directory  names.  By
  180.           default, zip will store the full path (relative  to
  181.           the current path).
  182.  
  183.        -J     Strip any prepended data (e.g. a SFX stub) from the
  184.           archive.
  185.  
  186.        -k     Attempt to convert the names and paths  to  conform
  187.           to  MSDOS, store only the MSDOS attribute (just the
  188.           user write attribute from UNIX), and mark the entry
  189.  
  190.       as  made    under MSDOS (even though it was not); for
  191.           compatibility with PKUNZIP under MSDOS which cannot
  192.           handle certain names such as those with two dots.
  193.  
  194.        -l     Translate     the  Unix  end-of-line character LF into
  195.           the MSDOS convention CR LF. This option should  not
  196.           be  used    on binary files.  This option can be used
  197.           on Unix if the zip file  is  intended  for  PKUNZIP
  198.           under  MSDOS. If the input files already contain CR
  199.  
  200.       LF, this option adds an extra CR. This ensure  that
  201.           unzip -a on Unix will get back an exact copy of the
  202.           original file, to undo the effect of zip -l.
  203.  
  204.        -ll    Translate the MSDOS end-of-line CR LF into Unix LF.
  205.           This  option  s